home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / descrp22.zip / DESCRIP.DOC < prev    next >
Text File  |  1991-01-16  |  15KB  |  270 lines
  1.  
  2.  
  3.                              DESCRIP, etc.
  4.  
  5.  
  6.  
  7.     Ok, well I finally overcame my lazyness and decided to make these
  8. programs semi-presentable so I could post them. The programs were written
  9. with the intent of creating a database of all the files I have on diskette.
  10. After writing the programs to automatically enter the contents of a floppy
  11. into an importable ascii database file and entering about two hunderd high
  12. density diskettes, it occurred to me that I would have to enter almost 3000
  13. descriptions which is beyond the scope of my present lifetime. So I wrote
  14. the rest of the programs to let me "steal" the file descriptions from the
  15. pcbfiles.lst file which I could d/l from my local bbs. Enough rambling, the
  16. following programs should be included in this zip.
  17.  
  18.  
  19.  
  20.      This is by no means a fancy package (the words "quick and dirty" come
  21. to mind), but some of y'all might find it useful.
  22.  
  23. ADDDSKS1 EXE  - shell to process sequentially numbered disks - use w/ a.bat
  24.                 and dir2file
  25. DIR2FILE EXE  - use w/ a.bat to get diskette dir listings into importable
  26.                 ASCII format
  27. A        BAT  - rearrange this to suit your taste needs to be used w/ adddsks1
  28.                 & dir2file
  29. DATEFMT  EXE  - convert output from dir2file to mm/dd/yy format (if you need it)
  30. SEQ2RND  EXE  - convert sequential files to/from random files
  31. DESCRIP1 EXE  - steal descriptions from bbs filelist
  32. DESCRIP2 EXE  - same as descrip1, only doesn't compare file extentions,
  33.                 good for different archive types or picture formats
  34. PCB2TXT  EXE  - convert standard pcbfiles.lst to importable format
  35. BRN2TXT  EXE  - convert Brentwood style BBSfilelist to importable format.
  36. EXEC2TXT EXE  - convert execnet format filelist to importable format
  37. CLOSQUOT EXE  - adds closing quotes to lines that may be missing them
  38. ADDFIELD EXE  - adds two empty fields to delimeted file (,"","")
  39. _____________________________________________________________________________
  40.  
  41.  
  42.     Here's the knarly details. The first 3 files (listed above) take a
  43. floppy in drive a: and put the directory in importable format, adding a
  44. field for the volume label (which can be the actual volume label written
  45. on the disk magnetically, or just the label you write on the floppy
  46. sticker) - it must be entered manually in either case. It is 11 chars
  47. max. To process single diskettes, enter "a <volumelabel>", if you have
  48. multiple diskettes to process, adddsks1 will let you enter a root and a
  49. number to start with. (if your root is "tp" and you start with "33", the
  50. labels will be entered into the file as "tp33", "tp34", etc.) The output
  51. of these programs consists of a file called "master.txt" with filename,
  52. bytes, date, and volumelabel fields. NOTE: All text fields have strings
  53. enclosed by quotes, and use a comma delimiter, and a cr/lf at the end of
  54. a line. Also, most of these programs look for commmand.com in c:\. Oh,
  55. yeah, you can run datefmt on master.txt if you need to change the date
  56. format from mm-dd-yy to mm/dd/yy. Next,you have to add two empty fields
  57. to the master file.  I do a few disks at a time, then import master.txt
  58. into paradox, then restructure the table to include a "category" field
  59. (9 chars) and a "description" field (255 chars). The field names don't
  60. matter at this point since I export the my whole list into a textfile
  61. before I do the rest. If you don't have a database program, you'll have
  62. to use the addfield program (syntax: ADDFIELD <infile> <outfile>) or use
  63. an editor to add the 2 blank fields (,"",""), the list wont be of much
  64. use anyway unless you have some program to make it user-friendly. Next,
  65. you will need a bbs file list with descriptions, etc. Use pcb2txt to
  66. convert stansdard pcbfiles.lst to importable format. This is
  67. pcbfiles.lst format, at least the one's I've seen:
  68.  
  69.  
  70. ╒═════════════════════════════════════════════════════════════════════════════╕
  71. │                              Over The Edge BBS                              │
  72. │                     Communications Programs & Utilities                     │
  73. ├─────────────────────────────────────────────────────────────────────────────┤
  74. ├─────────────┤ Last Updated on August 30, 1990     at 4:03 AM  ├─────────────┤
  75. ├─────────────────────────────────────────────────────────────────────────────┤
  76. │                               On-Line           Off-Line                    │
  77. │           Total Files :            72                  0                    │
  78. │           Total Bytes :     4,731,500                  0                    │
  79. ├─────────────────────────────────────────────────────────────────────────────┤
  80. │Filename      Size      Date    File Description                             │
  81. ╘═════════════════════════════════════════════════════════════════════════════╛
  82. 121.ZIP         32031  03-17-90  121 communications program
  83. 19200.ZIP         640  05-25-90  lets COM1 operate at 19200 baud
  84. APILOT17.ZIP    76337  03-12-90  Add external protocols to many programs
  85.                                | D/L  2
  86. ASPFILE2.ZIP     5017  05-11-90  script files for pcplus to logon to WC & PCB
  87. AT.ZIP           3077  06-19-88  Alows you to enter modem commands from DOS
  88. ATSET.ZIP       31315  03-17-90  set hayes modem ram for ATZ command          
  89. BBPOWERI.ZIP   128663  03-17-90  byte bros. powernode I external protocol
  90.                                | shell
  91.                        
  92. -----------------------------------------------------------------------------
  93. etc.,etc. An other bbs format that can be dealt with is what I found on
  94. execnet (in Mt. Vernon, NY), which is a variation on pcbfiles.lst. To process
  95. this format, use the exec2txt program. Here's an example of that format:
  96.  
  97.  
  98.  
  99.        -=  The Executive Network - A Professional Information System  =-
  100.        Catalog of files by subject, in alphabetical order as of 08-27-90
  101.  
  102.      Main Board Directory 1 - Communications Programs and Related Utilities
  103.  
  104.  
  105.  FILENAME         SIZE    DATE      D E S C R I P T I O N
  106.  ------------------------------------------------------------------------------
  107.  
  108.  
  109.        *   LOOKING FOR QMODEM?  JOIN THE QMODEM SUPPORT CONFERENCE FOR   *
  110.            *   SUPPORT AND 4 DIRECTORIES DEDICATED TO QMODEM ONLY!   *
  111.  
  112.  
  113.  1200BDTR.ZIP     3207  06-16-90  1200 Baud Dtr Carrier Dropping.
  114.  121-V22.ZIP     71974  03-25-88  Latest Version of PC to pc Communications.
  115.  1401INFO.ZIP     7033  06-03-88  GT14.01 Bug Fix InformationN
  116.  16550A.ZIP       5448  06-25-89  Turn The 16550an Uart Fifo Buffer On/Off
  117.  192HST10.ZIP    14244  01-01-89  19200hst V1.0: Configures USR Hst Modems to
  118.                                   Run at 19200: Shuts Off Data Compress For
  119.                                   Faster Arc Xfers W/Tp5 Source
  120.  1TO1-V22.ZIP    72052  07-19-90  Talk While Exhanging File (Excellent)
  121.  224SET.ZIP       1549  11-27-87  Settings For M224e From Forbin.
  122. _____________________________________________________________________________
  123.  
  124. Here is another file format that you can process; the program to process
  125. this format is brn2txt.exe -- you will have to remove the header with an
  126. editor before you process it though. Header
  127.                                        V
  128.                                        V
  129.                                        V
  130.                               The Brentwood BBS!
  131.                                 Filename: DIR19
  132.                             Updated:  Dec 16, 1990
  133.                                  12:07:00 pm                          Page: 1
  134.  
  135.  
  136. CLNUP200.ZIP    57010  10-27-90  Cleanup Ver 2.00. Cleans up All Those
  137.                                  Temporary And Backup Files on Your Disks. Now
  138.                                  Supports DOS Commands And Can Exclude
  139.                                  Directories From Processing.
  140. COMMCHK.ZIP     20799  10-27-90  Utility to Verify Command.COM.
  141. CRCSET.ZIP      34058  11-25-90  Anti-Virus Protection Utility That Uses A
  142.                                  32-Bit Crc to Test The Integrity of The
  143.                                  Running Program. Supporting Code in Turbo C
  144.                                  And Turbo Pascal is Included, as is Full
  145.                                  Documentation.
  146.  
  147. *** cont'd ***                                                       Page: 2
  148. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  149.  
  150. CURE100.ZIP      8614  12-01-89  Placebo V1.0: The Ultimate Virus 
  151.                                  Scare Cure.
  152. DC89SCAN.ZIP    17363  11-15-89  Scans For DatacRIME Virus Version 1(A) & 1(b)
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.      Ok, now you have a bbs filelist file and a list of your own files
  162. on floppy without descriptions or categories (after you use these utils
  163. once, you will have categories & descriptions for some files; don't
  164. worry, they will not be overwritten; only empty fields are filled in).
  165. Now you have to sort the bbs file alphabetically by filename. This is
  166. because the main program uses a binary search to speed up processing; my
  167. first attempt at this didn't, and I figured that it would've taken 3
  168. weeks to process 3000 filenames on my 10Mhz 286. As it is, the program
  169. takes between 5 and 15 minutes, depending on the size of the bbs file.
  170. Ok, now that you have an alphabetized bbs file (from now on referred to
  171. as bbs.seq -seq=sequential) and your personal floppy index file (now
  172. referred to as idx.seq - not necessarily alpabetized). If you plan to
  173. fill in the category field as well as the desc. field, you will have to
  174. process each bbs directory listing individually. If this is the case,
  175. then at this point (after alphabetizing) decide on a category name for
  176. the bbs.seq which you are about to process (0-9 chars) -- lets say you
  177. picked "util/disk" for your category name. Then you would add the line:
  178. "categoryxxxx","util/disk" to the top of bbs.seq before proceeding. Now
  179. you got to convert the sequential files to random access files
  180. (necessary for binary search) with the seq2rnd program. Choice 1 will
  181. take bbs.seq (and it must be named that) and convert it to bbs.rnd
  182. --bbs.seq has 2 fields, filename and description (enclosed in quotes,
  183. etc.). Choice 2 converts idx.seq to idx.rnd (idx.seq consists of the
  184. following fields: filename, bytes, date, volumelabel[11], category[9],
  185. description[255]) Note - random access files, like database files, are
  186. much larger than the ascii equivalent. a 100k ascii file may yeild a
  187. 900k .RND file. If for some reason you need to convert bbs.rnd back to
  188. bbs.seq, choice 4 will do it for you (like if you delete your originals)
  189. - these programs use output files and do not overwrite the input files.
  190. So anyway, you have bbs.rnd and idx.rnd, now it's funtime. if you want
  191. to steal descriptions if the whole ilename matches, use descrip1; if you
  192. want to ignore the file extentions, (good for gifs, which some people
  193. zip & some don't, or if you have a mixture of zip, arc, pak, whatever)
  194. use descrip2. If you just enter the program names without a commandline,
  195. you will be treated to the command syntax. A couple of things to note,
  196. these programs (especially descrip1 & 2) work more reliably if you
  197. execute them directly from the commandline. There is nothing wrong with
  198. the programs themselves, but I have gotten corrupted files by executing
  199. them from inside a shell (only occasionally) - This may be due to a bug
  200. in the turbo pascal 5.5 compiler, I don't know. Also, make sure you
  201. leave enough disk free for the output file (which should be the same
  202. size as idx.rnd) When you get your output file, rename it out.rnd, run
  203. seq2rnd, choose choice 3, and soon you will have out.seq, the finished
  204. product. Hey - if you're doing a bunch of directories from your bbs
  205. list, you can rename out.rnd to idx.rnd, make a new bbs.rnd (or whatever
  206. filenames) and go for it again. One more note, if there were any
  207. descriptions longer than 255 characters, they will be truncated, and
  208. will more than likely be missing a closing quote, which your database
  209. program may not like (mine doesn't) - also now and again a line of
  210. garbage will result from who knows what. Double quotes should be
  211. replaced by single quotes using a text editor global replace " with '
  212. (^qa - " - ' - N(o ask) in qedit) before any program is run on the bbs
  213. files (in other words, when they're fresh off the bbs). To fix the
  214. unclosed quotes, run the program CLOSQUOT (syntax: CLOSQUOT <infile>
  215. <outfile>).  Like I said, these programs are quick & dirty, but you
  216. might need them, (chances are if you read this far...) so what the hey.
  217.  
  218.     Starting with version 2.0, this program is shareware. If you use it,
  219. please send me $5.00. Registered users are entitled to support which
  220. includes my adding support for bbs file formats which you may need to
  221. process. If there is a bbsfile format you want to be able to process,
  222. send me a sample of it with your $5 and I will implement it (I will have
  223. to charge you an additional $1.50 for each disk I mail you though). This
  224. is still a bargain. If any of you want the tp5.5 code, it'll cost you
  225. $10. My adress is below, you can also reach me on the boards listed at
  226. the bottom of the doc - if there is another update, you'll find it on
  227. those boards.
  228.  
  229. My address:
  230.    David Lipper
  231.    41 Greenridge Ave.
  232.    White Plains, NY 10605
  233.  
  234.  
  235. Over The Edge BBS - 300-19,200 HST (914) 747-4635
  236. Brentwood BBS 1200/2400 (38,400 HST w/ subscription)  (914) 835-7898
  237. Cloud-9 BBS (914) 682-1965  300-19,200 HST D/S
  238.  
  239. You can send me mail on these boards or at:
  240. UNIX mail: cit2221@uncnsrd.UUCP
  241. Internet: cis.ohio-state.edu!edspny!uncnsrd!cit2221
  242. _____________________________________________________________________
  243. NOTE: These programs do no error checking, so if you misspell a filename,
  244. most of them will go ahead and run until they run out of hard disk space,
  245. and then some. So check your spelling, etc. & if they seem to be taking too
  246. long, hit ctrl-break or reset. All the programs run pretty fast (under 2
  247. minutes), except for descrip1 & 2, which, with idx.seq=150k & bbs.seq=300k,
  248. take maybe 8-15 minutes on my 10Mhz 286 w/ 40ms HD. It runs considerably
  249. faster on my 386/25 w/ 24ms HD (which used to be a 286/10...).
  250. ALSO, make sure you have LOTS of HD space free -- My idx.seq
  251. (sequential) file which is about 350k produces a idx.rnd (random) file
  252. of about 1.5 megs; also remember that when you run descrip, it will
  253. produce an output file the same size as the input file.
  254.  
  255. Turbo Pascal is a trademark of Borland International.
  256. Quickbasic is a trademark of Microsoft Corp.
  257.  
  258. Revision history:
  259. 1.0 initial release
  260. 2.0 Added a couple of utility programs (ADDFIELD, CLOSQUOT); fixed a
  261.     couple of bugs, like SEQ2RND was corrupting entries with less than 3
  262.     characters in the extension. Fixed. Descrip now has a running
  263.     display of what record # it's processing, so you'll know it's
  264.     working & how long it's gonna take. Added a third BBSfile format
  265.     that can be processed.
  266. 2.1 Fixed bug in SEQ2RND which prevented the other stuff from working.
  267. 2.2 Gee I goofed, I forgot to include BRUN45.EXE, which is necessary for
  268.     some of the programs to work. This version includes it. (boy do I
  269.     feel stupid...)
  270.